<?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content=
    "application/xhtml+xml; charset=iso-8859-1" />
    <title>
      Gutenprint-5.3.3
    </title>
    <link rel="stylesheet" type="text/css" href="../stylesheets/lfs.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.78.1" />
    <link rel="stylesheet" href="../stylesheets/lfs-print.css" type=
    "text/css" media="print" />
  </head>
  <body class="blfs" id="blfs-2020-04-02">
    <div class="navheader">
      <h4>
        Beyond Linux<sup>�</sup> From Scratch <span class="phrase">(System
        V</span> Edition) - Version 2020-04-02
      </h4>
      <h3>
        Chapter&nbsp;46.&nbsp;Printing
      </h3>
      <ul>
        <li class="prev">
          <a accesskey="p" href="gs.html" title="ghostscript-9.52">Prev</a>
          <p>
            ghostscript-9.52
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="scanning.html" title="Scanning">Next</a>
          <p>
            Scanning
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="printing.html" title=
          "Chapter&nbsp;46.&nbsp;Printing">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 2020-04-02">
          Home</a>
        </li>
      </ul>
    </div>
    <div class="sect1" lang="en" xml:lang="en">
      <h1 class="sect1">
        <a id="gutenprint" name="gutenprint"></a>Gutenprint-5.3.3
      </h1>
      <div class="package" lang="en" xml:lang="en">
        <h2 class="sect2">
          Introduction to Gutenprint
        </h2>
        <p>
          The <span class="application">Gutenprint</span> (formerly
          <span class="application">Gimp-Print</span>) package contains high
          quality drivers for many brands and models of printers for use with
          <a class="xref" href="cups.html" title="Cups-2.3.1">Cups-2.3.1</a>
          and the <span class="application">GIMP-2.0</span>. See a list of
          supported printers at <a class="ulink" href=
          "http://gutenprint.sourceforge.net/p_Supported_Printers.php">http://gutenprint.sourceforge.net/p_Supported_Printers.php</a>.
        </p>
        <p>
          This package is known to build and work properly using an LFS-9.1
          platform.
        </p>
        <h3>
          Package Information
        </h3>
        <div class="itemizedlist">
          <ul class="compact">
            <li class="listitem">
              <p>
                Download (HTTP): <a class="ulink" href=
                "https://downloads.sourceforge.net/gimp-print/gutenprint-5.3.3.tar.xz">
                https://downloads.sourceforge.net/gimp-print/gutenprint-5.3.3.tar.xz</a>
              </p>
            </li>
            <li class="listitem">
              <p>
                Download MD5 sum: 8703d3e27283c4cf9cd475aaacfe8e4b
              </p>
            </li>
            <li class="listitem">
              <p>
                Download size: 4.8 MB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated disk space required: 57 MB (without tests)
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated build time: 0.2 SBU (without tests)
              </p>
            </li>
          </ul>
        </div>
        <h3>
          Gutenprint Dependencies
        </h3>
        <h4>
          Recommended
        </h4>
        <p class="recommended">
          <a class="xref" href="cups.html" title="Cups-2.3.1">Cups-2.3.1</a>
          and <a class="xref" href="../xsoft/gimp.html" title=
          "Gimp-2.10.18">Gimp-2.10.18</a>
        </p>
        <h4>
          Recommended (at runtime)
        </h4>
        <p class="recommended">
          Two families of DyeSub photo printers each require another library
          at runtime. Unless you have one of these devices you will not want
          these libraries.
        </p>
        <p class="recommended">
          For the Sinfonia S6145 and the Ciaat Brava 21, <a class="ulink"
          href=
          "http://git.shaftnet.org/cgit/selphy_print.git/tree/lib6145">libS6145ImageReProcess</a>,
          see <a class="ulink" href=
          "http://www.peachyphotos.com/blog/posts/201601301524-sinfonia-chc-s6145-cs2-and-ciaat-brava-21-revited/">
          Peachy Photos (Sinfonia)</a> for instructions on how to build and
          test this.
        </p>
        <p class="recommended">
          For the Mitsubishi D70 family and the similar Kodak 305, <a class=
          "ulink" href=
          "http://git.shaftnet.org/cgit/selphy_print.git/tree/lib70x">libMitsuD70ImageReProcess</a>,
          see <a class="ulink" href=
          "http://www.peachyphotos.com/blog/posts/201610061508-mitsubishi-cp-d70-family-working/">
          Peachy Photos (Mitsubishi CP-D70)</a> for instructions on how to
          build and test this.
        </p>
        <h4>
          Optional (to Regenerate Documentation)
        </h4>
        <p class="optional">
          <a class="xref" href="../general/imagemagick.html" title=
          "ImageMagick-7.0.9-23">ImageMagick-7.0.9-23</a>, <a class="xref"
          href="texlive.html" title=
          "texlive-20190410-source">texlive-20190410</a> (or <a class="xref"
          href="tl-installer.html" title=
          "install-tl-unx">install-tl-unx</a>), <a class="xref" href=
          "../general/doxygen.html" title=
          "Doxygen-1.8.17">Doxygen-1.8.17</a>, and <a class="xref" href=
          "docbook-utils.html" title=
          "DocBook-utils-0.6.14">DocBook-utils-0.6.14</a>
        </p>
        <p class="usernotes">
          User Notes: <a class="ulink" href=
          "http://wiki.linuxfromscratch.org/blfs/wiki/gutenprint">http://wiki.linuxfromscratch.org/blfs/wiki/gutenprint</a>
        </p>
      </div>
      <div class="kernel" lang="en" xml:lang="en">
        <h2 class="sect2">
          <a id="gutenprint-escputil" name="gutenprint-escputil"></a>Kernel
          Configuration
        </h2>
        <p>
          If you intend to use <span class="application">escputil</span> with
          a USB-connected Epson Stylus printer for commands such as
          <span class="command"><strong>--ink-level</strong></span> which
          need to access the raw device, you must enable the kernel's usblp
          driver. Enable the following options in your kernel configuration
          and recompile the kernel:
        </p>
        <pre class="screen">
<code class="literal">Device Drivers  ---&gt;
  [*] USB support  ---&gt;                          [CONFIG_USB_SUPPORT]
    &lt;*/M&gt;  OHCI HCD (USB 1.1) support            [CONFIG_USB_OHCI_HCD]
    &lt;*/M&gt;  UHCI HCD (most Intel and VIA) support [CONFIG_USB_UHCI_HCD]
    &lt;*/M&gt;  USB Printer support                   [CONFIG_USB_PRINTER]</code>
</pre>
      </div>
      <div class="installation" lang="en" xml:lang="en">
        <h2 class="sect2">
          Installation of Gutenprint
        </h2>
        <p>
          Install <span class="application">Gutenprint</span> by running the
          following commands:
        </p>
        <pre class="userinput">
<kbd class="command">sed -i 's|$(PACKAGE)/doc|doc/$(PACKAGE)-$(VERSION)|' \
       {,doc/,doc/developer/}Makefile.in &amp;&amp;

./configure --prefix=/usr --disable-static &amp;&amp;

make</kbd>
</pre>
        <p>
          To test the results, issue: <span class="command"><strong>make
          check</strong></span>. The tests take a very long time and use a
          lot of disk space. When last tested (version 5.2.15 in June 2019)
          this needed 75 SBU and 13.5 GB to complete the tests (one test,
          rastertogutenprint failed because the CUPS ppds are for a previous
          version. Maybe genppds should be run before the tests). Note that
          the tests used only one CPU.
        </p>
        <p>
          Now, as the <code class="systemitem">root</code> user:
        </p>
        <pre class="root">
<kbd class="command">make install &amp;&amp;
install -v -m755 -d /usr/share/doc/gutenprint-5.3.3/api/gutenprint{,ui2} &amp;&amp;
install -v -m644    doc/gutenprint/html/* \
                    /usr/share/doc/gutenprint-5.3.3/api/gutenprint &amp;&amp;
install -v -m644    doc/gutenprintui2/html/* \
                    /usr/share/doc/gutenprint-5.3.3/api/gutenprintui2</kbd>
</pre>
      </div>
      <div class="commands" lang="en" xml:lang="en">
        <h2 class="sect2">
          Command Explanations
        </h2>
        <p>
          <span class="command"><strong>sed -i '...'
          ...Makefile.in</strong></span>: This command is used so that the
          package documentation is installed in the conventional <code class=
          "filename">/usr/share/doc</code> directory structure instead of
          <code class="filename">/usr/share/gutenprint/doc</code>.
        </p>
        <p>
          <em class="parameter"><code>--disable-static</code></em>: This
          switch prevents installation of static versions of the libraries.
        </p>
      </div>
      <div class="configuration" lang="en" xml:lang="en">
        <h2 class="sect2">
          Configuring Gutenprint
        </h2>
        <div class="sect3" lang="en" xml:lang="en">
          <h3 class="sect3"></h3>
          <h4 class="title">
            <a id="idm140006413678592" name=
            "idm140006413678592"></a>Configuration Information
          </h4>
          <p>
            For <span class="application">CUPS</span> to see newly installed
            print drivers, it has to be restarted (as the <code class=
            "systemitem">root</code> user):
          </p>
          <pre class="root">
<kbd class="command">/etc/rc.d/init.d/cups restart</kbd>
</pre>
          <p>
            Then point your web browser to <a class="ulink" href=
            "http://localhost:631/">http://localhost:631/</a> to add a new
            printer to <span class="application">CUPS</span>.
          </p>
        </div>
      </div>
      <div class="content" lang="en" xml:lang="en">
        <h2 class="sect2">
          Contents
        </h2>
        <div class="segmentedlist">
          <div class="seglistitem">
            <div class="seg">
              <strong class="segtitle">Installed Programs:</strong>
              <span class="segbody">cups-calibrate, cups-genppd.5.2,
              cups-genppdupdate, escputil, and testpattern</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Libraries:</strong>
              <span class="segbody">libgutenprint.so, libgutenprintui2.so and
              optionally, various <span class="application">CUPS</span>
              filters and backend drivers under
              /usr/lib/gutenprint/5.2/modules/</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Directories:</strong>
              <span class="segbody">/usr/{include,lib,share}/gutenprint,
              /usr/include/gutenprintui2 and
              /usr/share/doc/gutenprint-5.3.3</span>
            </div>
          </div>
        </div>
        <div class="variablelist">
          <h3>
            Short Descriptions
          </h3>
          <table border="0" class="variablelist">
            <colgroup>
              <col align="left" valign="top" />
              <col />
            </colgroup>
            <tbody>
              <tr>
                <td>
                  <p>
                    <a id="cups-calibrate" name=
                    "cups-calibrate"></a><span class="term"><span class=
                    "command"><strong>cups-calibrate</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    calibrates the color output of printers using the
                    <span class="application">Gutenprint</span>, <span class=
                    "application">CUPS</span> or <span class=
                    "application">ESP Print Pro</span> drivers.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="cups-genppd.5.2" name=
                    "cups-genppd.5.2"></a><span class="term"><span class=
                    "command"><strong>cups-genppd.5.2</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    generates Gutenprint PPD files for use with CUPS.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="cups-genppdupdate" name=
                    "cups-genppdupdate"></a><span class="term"><span class=
                    "command"><strong>cups-genppdupdate</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    regenerates the Gutenprint PPD files in use by CUPS.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="escputil" name="escputil"></a><span class=
                    "term"><span class=
                    "command"><strong>escputil</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a command line utility to perform various maintenance
                    tasks on Epson Stylus inkjet printers.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="testpattern" name="testpattern"></a><span class=
                    "term"><span class=
                    "command"><strong>testpattern</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a test program to learn how to use libgutenprint.
                  </p>
                </td>
              </tr>
            </tbody>
          </table>
        </div>
      </div>
      <p class="updated">
        Last updated on 2020-03-25 07:06:24 -0500
      </p>
    </div>
    <div class="navfooter">
      <ul>
        <li class="prev">
          <a accesskey="p" href="gs.html" title="ghostscript-9.52">Prev</a>
          <p>
            ghostscript-9.52
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="scanning.html" title="Scanning">Next</a>
          <p>
            Scanning
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="printing.html" title=
          "Chapter&nbsp;46.&nbsp;Printing">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 2020-04-02">
          Home</a>
        </li>
      </ul>
    </div>
  </body>
</html>
